home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / dbill36.zip / DOORBILL.DOC < prev    next >
Text File  |  1993-01-13  |  23KB  |  558 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                  DOORBILL 3.6
  21.                                  ------------
  22.  
  23.                         One of the MicroNet Collection
  24.                         of Multi-BBS Doorware programs
  25.                             for systems supporting
  26.                        PCBOARD.SYS, USERS.SYS, DOOR.SYS,
  27.                    CALLINFO.BBS, SFDOORS.DAT or DORINFOx.DEF
  28.  
  29.                                       By
  30.  
  31.                                   Ted Freeman
  32.                                 P.O. Box 83401
  33.                             Oklahoma City, OK 73148
  34.  
  35.                              (C) Copyright 1990-91
  36.                               All Rights Reserved
  37.  
  38.  
  39.  
  40.  
  41. DOORBILL v3.6 - Users Guide - Page i
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                                 C O N T E N T S
  50.                                =================
  51.  
  52.         Warranty ............................................ 1
  53.  
  54.         Copyright notice .................................... 1
  55.  
  56.         Distribution ........................................ 1
  57.  
  58.         Description ......................................... 1
  59.  
  60.         Registration ........................................ 2
  61.  
  62.         DBUTIL .............................................. 3
  63.  
  64.           Categories (Add/Edit) ............................. 3
  65.  
  66.           Doors (Add/Edit) .................................. 4
  67.  
  68.           Post Bulletin ..................................... 5
  69.  
  70.           Sort Door Listings ................................ 5
  71.  
  72.         DoorBill Configuration Files ........................ 6
  73.  
  74.         Door Operation Information .......................... 7
  75.  
  76.         Miscellaneous Notes ................................. 8
  77.  
  78.         Order Form .......................................... 9
  79.  
  80.  
  81.  
  82. DOORBILL v3.6 - Users Guide - Page 1
  83.  
  84.  
  85.                                    WARRANTY
  86.                                    --------
  87.  
  88.     This product is provided "as is" without warranty of any kind. The entire
  89.     risk as to the results and  performance of the program is assumed by you.
  90.     Futhermore, the  author does  not warrant, guarantee, or  make any  other
  91.     representations regarding  the use of,  or the  results of the use of the
  92.     program,  and you  rely on the  program and  results  solely at  your own
  93.     risk.  The author  cannot and  will not accept  responsibility for system
  94.     damage, loss of profit, or any other special, consequential or incidental 
  95.     damages  resulting  from  the  use  or  inability  to  use this  product.
  96.  
  97.  
  98.                                    COPYRIGHT
  99.                                    ---------
  100.  
  101.     DOORBILL,  Copyright (c) 1990 by  Ted  Freeman, is being  distributed as
  102.     Shareware. Under this concept you may use the  SHAREWARE  (unregistered)
  103.     version for a reasonable period of  time for evaluation  after which you
  104.     must either register your copy or discontinue  usage.
  105.  
  106.  
  107.                                  DISTRIBUTION
  108.                                  ------------
  109.  
  110.     This program is being distributed via the SHAREWARE concept and as such,
  111.     may be copied freely with the following restrictions:
  112.  
  113.                 * The program must be supplied in it's original
  114.                   unmodified form, including documentation.
  115.  
  116.                 * DOORBILL may not be distributed as part of any
  117.                   commercial application or service without the
  118.                   express, written consent of the author.
  119.  
  120.                 * Vendors of Shareware/Public Domain software may
  121.                   not distribute this program without the express,
  122.                   written consent of the author, unless said Vendor
  123.                   has been approved by the Association of Shareware
  124.                   Professionals (ASP).
  125.  
  126.  
  127.                                   DESCRIPTION
  128.                                   -----------
  129.  
  130.     DOORBILL is a versatile Door manager that allows you to add or delete
  131.     Door programs to your BBS with relative ease. DOORBILL features many
  132.     options such as applying level restrictions to all Categories of Doors
  133.     as well as to each individual Door. In addition you may lock any Door
  134.     based solely on the caller's baud rate! DOORBILL options include the
  135.     viewing of your Doors/Games Bulletins online, running the included
  136.     utility program while the Sysop is in local mode, creating a Bulletin
  137.     listing of all your Door Categories and Doors available. You may add,
  138.     delete, move, sort, and insert Categories and Doors with just a couple
  139.     of keystrokes. DOORBILL is compatible with PCBoard v14.x, Wildcat!,
  140.     Spitfire, RBBS, QBBS, Remote Access, as well as those BBS systems
  141.     that utilize the standard 52-line DOOR.SYS file.
  142.  
  143.  
  144.  
  145. DOORBILL v3.6 - Users Guide - Page 2
  146.  
  147.  
  148.  
  149.                                  REGISTRATION
  150.                                  ------------
  151.  
  152.         DOORBILL represents many hours of programming and the author
  153.         deserves just compensation for his time, efforts and expertise.
  154.         If you find this program to be of some value and you continue
  155.         to use it on your BBS system, you must return the registration
  156.         form provided along with the registration fee. Registration
  157.         entitles you to free upgrades via modem from MicroNet's Support
  158.         Conference. Payments should be made in the form of a check or
  159.         money order (do NOT send cash!). Foreign orders must be in U.S.
  160.         funds drawn on a U.S. bank.
  161.  
  162.         Online registration with Visa or Mastercard is available via our
  163.         Credit Card Door on the following systems:
  164.  
  165.         MicroNet:  (405) 528-3175 HST      Livewire:  (609) 235-5297 MNP5
  166.           (OK)     (405) 528-8610                     (609) 866-2551 HST DS
  167.                    (405) 557-1103 ULTRA               (609) 727-3246 MNP5
  168.  
  169.                          -----------------------------
  170.  
  171.  
  172.  
  173. DOORBILL v3.6 - Users Guide - Page 3
  174.  
  175.                                   DBUTIL.EXE
  176.  
  177.                              Categories (Add/Edit)
  178.  
  179. DBUTIL.EXE is where you enter all data for your  doors.  It is  very  simple 
  180. to use  but we'll  take a walk through the prompts just to make sure. First, 
  181. we select "Categories (Add/Edit)". You may use the arrow keys or just type C.
  182.  
  183. Field 1: Use G]oodbye [Y]                                <- Optional Field
  184.  
  185.   For PCBoard systems only! Enter an N if you do not want your users to be
  186.   able to logoff from DoorBill. This field will default to Y.
  187.  
  188. Field 2: BLT Menu [C:\PCB\GAMES\BLT         ]            <- Optional Field
  189.  
  190.   Enter full Path/Filename for your DOORS BLT file (this is the menu of 
  191.   bulletins you create with The Draw or whatever). Both ASCII (BLT) and
  192.   ANSI graphics (BLTG) bulletins are supported but not PCBoard @X codes.
  193.   Leave this field blank to disable.
  194.  
  195. Field 3: BLT.LST  [C:\PCB\GAMES\BLT.LST     ]            <- Optional Field
  196.  
  197.   Enter the full Path/Filename for your DOOR/GAMES BLT.LST file. This file
  198.   must be compatible with the PCBoard BLT.LST format. This is a random 
  199.   access file with 30 byte fields for each entry. Leave blank to disable.
  200.  
  201. Field 4: BLT Path [C:\PCB\GEN\BLT1     ]                 <- Optional Field
  202.  
  203.   The BLT field is for those of you who wish to post a Bulletin of all
  204.   your Door Categories and their associated Doors. This filename must be
  205.   limited to 7 characters or less because a 'G' will be appended on the
  206.   ANSI bulletin. (See 'POST BULLETIN' q.v.)
  207.  
  208. Field 5: Auto-ANSI? [Y]
  209.  
  210.    This option toggles automatic ANSI detection. If this is on (default),
  211.    DoorBill will determine if the remote system has ANSI capabilities and
  212.    if so, will display the Menus using extended ASCII characters. If this
  213.    is set to 'N' or ANSI is not detected, the Menus use keyboard characters.
  214.    Whether color is displayed or not is determined by the BBS setting.
  215.  
  216. Field 6: HST [HST xxxxx ]                                <- Optional Field
  217.  
  218.   The HST field is for US Robotics HST owners that wish to run doors that
  219.   cannot  handle the high port speeds. DoorBill will switch the port speed
  220.   down to whatever the callers connect rate is (1200/2400 etc.). Valid
  221.   options  are HST 9600, HST 19200, HST 38400. If you don't have an HST or
  222.   don't want to use this option, just leave the field blank. Make sure this
  223.   agrees with your port speed in PCBSETUP or field 5 of DOOR.SYS.
  224.   NOTE: The S02 register on the HST must be set to 43 (S02=43)!
  225.  
  226. Lines 4 - 24:                                                LEVEL
  227. Title for Menu 1:  [Trivia and Word Games                 ]  [ 30]
  228. Title for Menu 2:  [Space and War Games                   ]  [100]
  229. Title for Menu 3:  [Miscellaneous                         ]  [ 50]  Etc.
  230.  
  231. DoorBill allows you to set a security level for each category. In the above
  232. example, a caller with level 50 would see only the 1st and 3rd entries 
  233. but for him they would be numbered 1 and 2. He will never be aware there is 
  234. another category there. A caller with level 100 would see all 3 entries.
  235. When the cursor is in one of the 20 Title or Level fields, F2 and F3 are 
  236. active for inserting and deleting entries.
  237.  
  238.  
  239.  
  240. DOORBILL v3.6 - Users Guide - Page 4
  241.  
  242.                                Doors (Add/Edit)
  243.                                ----------------
  244.  
  245. When you are done entering your Category Titles, just hit F1 and your
  246. data will be saved. You will now see a menu of the categories you just
  247. entered. The first entry will be highlighted. Just hit enter to select
  248. the highlighted item or use the arrow keys to move the highlighted bar.
  249. Using the example above, that would be Trivia and Word Games.
  250.  
  251. Now you will see "Enter Data for New Door" highlighted. Select this any 
  252. time you wish to add a new door.
  253.  
  254. Follow the example below and you should have no trouble getting your doors 
  255. entered. This is essentially just like you would write a regular Door batch 
  256. file.
  257.  
  258. Door Name for Menu: [Quizard's Mountain         ]
  259.  
  260. Description of Door: [Trivia and role playing all 'roled' into one!     ]
  261.  
  262. Path to this Door's Directory: [F:\DOORS\QM   <- Must exist. DoorBill checks!
  263.  
  264. Minimum Security to Access Door? [ 30]
  265.  
  266. Show Door to callers under level 30  [Y]  
  267.  
  268.  If you put Y this door will be shown to everyone, however those below
  269.  level 30 will NOT be allowed into this door. If you put N then it will
  270.  only be listed on the menu for level 30 and above.
  271.  
  272. Baud Rates Allowed     3[N]  12[Y]  24[Y]  48[Y]  96[N]  19.2[N]  38.4[N]
  273.  
  274.  In this example, anyone calling at baud rates of 300, 9600, 19200 and 38400 
  275.  would receive the message:
  276.        'This Door is not available at your current baud rate.'
  277.  and would be returned to the menu. The other baud rates would be allowed to
  278.  access the Door.
  279.  
  280. Command line 1: [HST   <- If you have an HST and have your Port locked, and
  281.   (optional)              this door doesn't run at the locked speed, by
  282.                           putting the HST command here, DoorBill will unlock
  283.         OR                the port and switch it to the callers connect rate.
  284.                           Make sure COMLOCK.EXE is in your DoorBill directory.
  285.  
  286. Command line  1: [QUIZRD31 QUIZARD.CFG                                   ]
  287.  .                              .                                        .
  288.  .                              .                                        .
  289. Command line 10: [                                                       ]
  290.  
  291. Conversion desired? (C/D/N/P/R/S): [D]
  292.  
  293. DoorBill will write a conversion file for the following formats:
  294.  
  295.      C = CALLINFO.BBS (Wildcat!)        D = DORINFO1.DEF (RBBS/QBBS/RA)
  296.      N = CHAIN.TXT (WWIV)               P = PCBOARD.SYS (For non-PCB systems)
  297.      R = DOOR.SYS (GAP 52 Line)         S = SFDOORS.DAT (Spitfire)
  298.  
  299. NOTE: For non-PCBoard systems, the P conversion creates PCBOARD.SYS only. See
  300.       the enclosed DUMMYPCB.ZIP file for dummy PCBOARD.DAT and USERS files.
  301.  
  302.  
  303.  
  304. DOORBILL v3.6 - Users Guide - Page 5
  305.  
  306.  
  307. If you wish to MOVE the Door to another Category, hit F4 and you will be
  308. shown a list of your active Categories and prompted for the number of the
  309. Category you wish to MOVE the Door to.
  310.  
  311. When the cursor is on one of the 10 Command Line fields, F1 and F2 become 
  312. active for inserting and deleting. You must hit F1 to save your data. Leaving 
  313. this screen via F9 or ESC will NOT save the data.
  314.  
  315. That's all there is to it! Just remember if you do enter the HST parameter, 
  316. it must be entered on Command Line 1.
  317.  
  318.  
  319.                                  Post Bulletin
  320.                                  -------------
  321.  
  322.   This option allows you to create a Bulletin file of all your Door
  323.   Categories and their associated Doors. Both ASCII and ANSI Bulletins
  324.   are created. The Bulletin will list all Categories and Doors so if you
  325.   have entries that you don't want everyone to see you will need to edit
  326.   those out of the Bulletin. The Bulletin is not created automatically.
  327.   You must select 'Post Bulletin' from DBUTIL's Main Menu. If you leave
  328.   the BLT Path field blank and select 'Post Bulletin', two files will be
  329.   created in the DoorBill directory with filenames of  'DOORBLT' and
  330.   'DOORBLTG'.
  331.  
  332.  
  333.                               Sort Door Listings
  334.                               ------------------
  335.  
  336.   This option sorts all Door listings in all Categories into alphabetical
  337.   order.
  338.  
  339.  
  340.  
  341. DOORBILL v3.6 - Users Guide - Page 6
  342.  
  343.  
  344.                                  DOORBILL.CFG
  345.                                  ------------
  346.  
  347. Configuration file when using USERS.SYS:
  348.    (Also accesses PCBOARD.SYS, PCBOARD.DAT, USERS, and CALLERx)
  349.    C:\PCB\USERS.SYS                    <- Path/filename to USERS.SYS
  350.    MicroNet PCBoard                    <- Name of BBS
  351.    Ted                                 <- Sysop's first name
  352.    Freeman                             <- Sysop's last Name
  353.  
  354. Configuration file when using PCBOARD.SYS:
  355.    (Also accesses PCBOARD.DAT, USERS, and CALLERx)
  356.    C:\PCB\PCBOARD.SYS                  <- Path/filename to PCBOARD.SYS
  357.    MicroNet PCBoard                    <- Name of BBS
  358.    Ted                                 <- Sysop's first name
  359.    Freeman                             <- Sysop's last Name
  360.  
  361. Configuration file when using DOOR.SYS:
  362.    C:\PCB\DOOR.SYS                     <- Path/filename to DOOR.SYS
  363.    MicroNet PCBoard                    <- Name of BBS
  364.    Ted                                 <- Sysop's first name
  365.    Freeman                             <- Sysop's last Name
  366.  
  367. Configuration file when using DORINFO1.DEF:
  368.    C:\BBS\DORINFO1.DEF                 <- Path/filename to DORINFO1.DEF
  369.                                           where 'x' is the Node number.
  370.    MicroNet PCBoard                    <- Name of BBS
  371.    Ted                                 <- Sysop's first name
  372.    Freeman                             <- Sysop's last Name
  373.  
  374. Configuration file when using CALLINFO.BBS:
  375.    C:\BBS\CALLINFO.BBS                 <- Path/filename to CALLINFO.BBS
  376.    MicroNet PCBoard                    <- Name of BBS
  377.    Ted                                 <- Sysop's first name
  378.    Freeman                             <- Sysop's last Name
  379.  
  380. Configuration file when using SFDOORS.DAT:
  381.    C:\BBS\SFDOORS.DAT                  <- Path/filename to SFDOORS.DAT
  382.    MicroNet PCBoard                    <- Name of BBS
  383.    Ted                                 <- Sysop's first name
  384.    Freeman                             <- Sysop's last Name
  385.  
  386. Configuration file when using CHAIN.TXT:
  387.    C:\BBS\CHAIN.TXT                    <- Path/filename to CHAIN.TXT
  388.    MicroNet PCBoard                    <- Name of BBS
  389.    Ted                                 <- Sysop's first name
  390.    Freeman                             <- Sysop's last Name
  391.  
  392. Configuration file when using GTUSER.BBS:
  393.    C:\BBS\GTUSER.BBS                   <- Path/filename to GTUSER.BBS
  394.    MicroNet PCBoard                    <- Name of BBS
  395.    Ted                                 <- Sysop's first name
  396.    Freeman                             <- Sysop's last Name
  397.    1                                   <- COM port number
  398.  
  399.  
  400.  
  401. DOORBILL v3.6 - Users Guide - Page 7
  402.  
  403.                               DOORBILL BATCH FILE
  404.                               -------------------
  405.  
  406. This is the batch file whose name is entered in PCBSETUP or the corresponding
  407. utility for your BBS. It should reside in your default BBS directory. Leave 
  408. this AS IS except for changing the paths. The 'x' in each line should be
  409. replaced with the NODE number (single node systems use 1).
  410.  
  411. ECHO OFF
  412. :START
  413. C:
  414. CD\PCB\DOORBILL                         
  415. IF EXIST DBRUNx.BAT DEL DBRUNx.BAT
  416. IF EXIST ENDBILL.x DEL ENDBILL.x
  417. DOORBILL DOORBILL.CFG                   <-- (see note 2 below)
  418. IF EXIST ENDBILL.x GOTO EXIT
  419. IF NOT EXIST DBRUNx.BAT GOTO EXIT
  420. CALL BILLRUN
  421. GOTO START
  422. :EXIT
  423. C:
  424. CD\PCB
  425. BOARD
  426.  
  427.    1: DoorBill requires the presence of BRUN45.EXE either in the same
  428.       directory as DoorBill or accessible via PATH. 
  429.    2: Doorbill supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  430.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ add the IRQ
  431.       number after the configuration filename. For example, to use IRQ 5:
  432.         DOORBILL DOORBILL.CFG /5
  433.  
  434.                      ------------------------------------
  435.  
  436.  
  437.                                 DOOR OPERATION
  438.                                 --------------
  439.   
  440.   F3    -   Toggles the printer On/Off. Value is passed to PCBoard.
  441.   F4    -   Toggles the Page Bell On/Off. Value is passed to PCBoard.
  442.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  443.   F7    -   Toggles the Caller Alarm On/Off. Value is passed to PCBoard.
  444.   F8    -   Returns the caller involuntarily to the BBS.
  445.   F9    -   Toggles the local display On/Off. Value is passed to PCBoard.
  446.   F10   -   Activates SysOp CHAT mode within the DOOR.
  447.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  448.   HOME  -   HELP key for status line options.
  449.   UP    -   Allows the SysOp to give the caller extra time while in the DOOR.
  450.   DN    -   Allows the SysOp to subtract time from the caller.
  451.  
  452.       NOTE: Time and Level changes are passed to the BBS when using USERS.SYS,
  453.             SFDOORS.DAT, CALLINFO.BBS or DOOR.SYS.
  454.  
  455.   ALT-N -   SysOp next on toggle. (available only with USERS.SYS or 
  456.             PCBOARD.SYS). Value is passed to PCBoard.
  457.   ALT-X -   Exit to DOS after current caller logs off. (Available only
  458.             with USERS.SYS or PCBOARD.SYS). Value is passed to PCBoard.
  459.  
  460.  
  461. DOORBILL v3.6 - Users Guide - Page 8
  462.  
  463.                               MISCELLANEOUS NOTES
  464.                               -------------------
  465.  
  466.  
  467.       * The Printer, Page Bell, and Call Alarm toggles as well as any
  468.         changes in caller's Time or Level are written to DOOR.SYS,
  469.         CALLINFO.BBS and SFDOORS.DAT.
  470.  
  471.       * PCBoard's Call Waiting screen is only updated when using the
  472.         USERS.SYS file and not when using PCBOARD.SYS.
  473.  
  474.       * DoorBill creates it's own time keeping file called DBILLx.TIM.
  475.         If for some reason this doesn't get deleted, it could cause problems
  476.         for the next caller (like a Time Expired message!). To prevent this
  477.         simply add the following in the batch file that runs the BBS (NOT
  478.         DOORBILL'S BATCH FILE!). For PCBoard this is usually BOARD.BAT.
  479.  
  480.         IF EXIST C:\DOORBILL\DBILLx.TIM DEL C:\DOORBILL\DBILLx.TIM
  481.  
  482.         Of course you would substitute your own path to the DoorBill dir.
  483.         Substitute the Node number for the x.
  484.  
  485.       * GT Sysops please note that the COM port number must be included
  486.         on line 5 of the configuration file! When assigning security levels
  487.         for the Categories and Doors, Doorbill assigns levels as follows:
  488.         (9 to 0) = (53 to 62)
  489.         (A to Z) = (27 to 52)
  490.         (a to z) = (1 to 26)
  491.  
  492.  
  493.  
  494.  
  495.          M I C R O N E T  D O O R   R E G I S T R A T I O N   F O R M 
  496.  
  497.  
  498.         TO:  MicroNet                                   Date___/___/___ 
  499.              P.O. Box 83401  
  500.              Oklahoma City, OK 73148
  501.  
  502.  
  503.             (Please use capitalization and punctuation where necessary.)
  504.  
  505.  
  506.       FROM:  SysOp Name: _______________________________________________ 
  507.  
  508.              BBS Name: _________________________________________________
  509.  
  510.              Address: __________________________________________________ 
  511.  
  512.              City: ______________________ State: __________ ZIP: _______ 
  513.  
  514.              Voice: (   ) _________________ BBS: (   ) _________________
  515.  
  516.              BBS Software: _____________________ BBS Hours: ____________
  517.  
  518.              Baud Rates:________________________ 
  519.  
  520.  
  521.       SOFTWARE                          VERSION                  PRICE 
  522.       --------                          -------                  -----
  523.  
  524.       DoorBill........................... 3.4 ................. $30.00 __
  525.       Quizard's Mountain................. 3.1 ................. $25.00 __
  526.       Eliminate ......................... 4.2 ................. $20.00 __
  527.       Total Recall....................... 3.2 ................. $20.00 __
  528.       4 Square .......................... 1.0 ................. $20.00 __
  529.       Peg Jump .......................... 1.0 ................. $20.00 __
  530.       (Current versions as of 02-21-91)
  531.                                                                  _____
  532.  
  533.       (OK residents add 7% tax)                                  _____
  534.  
  535.       (Foreign orders add $10.00 for shipping)                   _____
  536.  
  537.       Total                                                    $______ 
  538.  
  539.  
  540.                                 F E E D B A C K 
  541.                                 ---------------
  542.  
  543.       I learned of DOORBILL from: 
  544.                 [  ] - A Friend         [  ] - Computer Club
  545.                 [  ] - BBS              [  ] - Compuserve
  546.                 [  ] - GEnie            [  ] - Other 
  547.  
  548.       COMMENTS: _____________________________________________________ 
  549.       _______________________________________________________________ 
  550.       _______________________________________________________________ 
  551.       _______________________________________________________________ 
  552.       _______________________________________________________________ 
  553.       _______________________________________________________________ 
  554.       _______________________________________________________________ 
  555.       _______________________________________________________________ 
  556.  
  557.  
  558.